package com.campus.help.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.campus.help.entity.Banner;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;
import java.util.Map;

/**
 * 轮播图Mapper接口
 */
@Mapper
public interface BannerMapper extends BaseMapper<Banner> {

    /**
     * 分页查询轮播图
     * @param page 分页参数
     * @param keyword 关键词
     * @param status 状态
     * @return 分页结果
     */
    IPage<Banner> selectBannerPage(Page<Banner> page, 
                                  @Param("keyword") String keyword, 
                                  @Param("status") Integer status);

    /**
     * 查询有效的轮播图列表（用于前端展示）
     */
    List<Banner> selectActiveBanners();

    /**
     * 更新轮播图点击次数
     */
    int incrementClickCount(@Param("bannerId") Long bannerId);

    /**
     * 批量更新轮播图状态
     */
    int batchUpdateStatus(@Param("ids") List<Long> ids, 
                         @Param("status") Integer status, 
                         @Param("updateBy") Long updateBy);

    /**
     * 批量更新排序值
     */
    int batchUpdateSortOrder(@Param("list") List<Map<String, Object>> list);

    /**
     * 获取下一个排序值
     */
    Integer getNextSortOrder();

    /**
     * 统计轮播图数据
     */
    Map<String, Object> getBannerStats();

    /**
     * 查询即将过期的轮播图
     */
    List<Banner> selectExpiringBanners(@Param("days") Integer days);

    /**
     * 查询点击量最高的轮播图
     */
    List<Banner> selectTopClickedBanners(@Param("limit") Integer limit);

    /**
     * 重置排序值
     */
    int resetSortOrder();
}
